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Preface 



These release notes accompany the xn/News server provided with release 1 .0 
of Open Windows . The notes discuss changes that have been made to News 
since the release of News 1.1; they also discuss differences from release 3 of xn, 
from MIT. This document should be read by customers who have been using 
either News 1.1 or public domain versions of the xn server available from MIT. 

After reading these release notes, reread the Read This First document provided 
with this release of Open Windows. 

The XView toolkit, the News toolkit, and the Xii/News window manager are 
based on an early version of the OPEN LOOK Graphical User Interface 
Specification, and they therefore do not necessarily implement every element in 
the most recent revision of that specification 1 OPEN LOOK references thus point 
to software that has not yet been validated by AT&T as fully OPEN LOOK com- 
pliant, although full validation is expected shortly. 



1 OPEN LOOK™ is a trademaik of AT&T. 
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Introduction 



This document describes the notable changes and enhancements in release 1.0 
(Revision A) of Xii/NeWS, compared with both News 1.1 and the XI 1 Release 3 
window system available from MIT. 

News is now supported as part of the XI 1/NeWS server, which itself forms a part of 
the OpenWindows distributed window system. The Xii/NeWS server runs win- 
dowing applications written with either the xn or the News protocol. Though the 
two protocols are entirely different, Xii/NeWS provides an integrated environment 
in which both are supported. Thus, whenxn and News applications simultane- 
ously display windows, the windows coexist on the screen and can be made to 
overlap in any way. Cut and paste selections can be made between xn and News 
windows. All the windows are manipulated by a single window manager. 

The Xii/News server, which forms the window system platform of the OpenWin- 
dows environment, can be used to run applications of the following kinds: 

□ All correctly-written XI l applications, such as those built with the XView 
user interface 

d News applications that conform to News 1.1 documented interfaces (includ- 
ing Lite toolkit-based applications) 

a SunView- and SunWindows-based applications 

The server also supports the running of networked applications: thus, you can 
run client programs on remote machines, using your local machine to display the 
corresponding windows. 

A set of XView applications is provided with this release of OpenWindows; the 
set includes a shell command tool, a file manager, a text editor, a mail tool, and 
other tools. 
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Changes to NeWS 



Numerous features have been added to the News language, including extensible 
NeWS objects, packed arrays, classes for input handling, and better support of the 
PostScript language as defined in the PostScript Language Reference Manual. 

In addition, the following changes have occurred: 

n The News toolkit (formally known as the NtWS Development Environment or 
NDE) has become the preferred NeWS-based toolkit. The old Lite toolkit has 
been retained in its original form but will no longer be enhanced. 

□ Windows provided by XView and the NeWS toolkit correspond to the OPEN 
LOOK User Interface Specification. OPEN LOOK is an easy-to-use graphical 
interface. 

d Minor differences between the XI l and NeWS window systems have necessi- 
tated changes to the News language. 

n Adjustments have been made to facilitate future development of the product 
and ensure continued quality. 

2.1. Changes in File The default installation-directory for OpenWindows is now, for all machines 

Location except the 386i, /home/openwin. For a 386i, the default installation- 

directoryis /files/local/sun386/openwin. You must then set the 
environment variable OPENWINHOME to the directory in which the product 
has been installed. The NEWSHOME environment variable is now ignored. See 
the OpenWindows Installation and Start-Up Guide for full information. 

The following changes have also occurred: 

□ Startup files — The user . ps and startup . ps files, which are read from 
your home directory when Xii/News is started, have now been renamed 

.user.psand.startup.ps. 

□ Images are stored in $OPENWlNHOME/demo/images instead of 
$ NEWS HOME /smi. 

□ The client source is in $OPENWINHOME/share/src/xnews instead of 
$NEWSHOME/clientsrc. 

a The server is now $OPENWINHOME/bin/xnews, not 
$NEWSHOME/bin/news server. 
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2.2. Changes in File Access 



2.3. New Environment 
Variables 



2.4. Revised * .ps Files 



Root Menus 



d PostScript language files read in by the server at start-up are stored in 
$OPENWINHOME/etc/NeWS instead of $NEWSHOME/lib/NeWS. 

n Font files read in by the server are stored in 

$OPENWINHOME/ lib/ fonts. 

With the change in the location of the start-up PostScript language files, the file 
and run PostScript language operators (together with all the News utilities that 
use them) now search the following directories in turn: 

1. The directory . / (the directory in which the server has been started) 

2. The directory ~ / (the user's home directory) 

3. The directory $OPENWlNHOME/etc/ 

The Xii/News server offers a number of new environment variables. Among 
these is NEWSONLY. When no XI 1 clients will be run, NEWSONLY can be 
set to reduce memory consumption. See the manual page for xnews in the 
xu/NeWS Server Guide for a description of all the environment variables. 

Much of the behavior and functionality of the xu/News server is determined by 
files containing POSTSCRIPT language code read in at startup. These files are dif- 
ferent from the * . ps files in News 1.0 and 1.1; thus, News users may find some 
incompatibilities (these are described in this document). The changes have been 
made to allow the server to be started up in various modes (for example, as a 
filter, or as an ou^ut-onlv device\ 

The following sections discuss the incompatibilities in greater detail Refer to 
the N<WS Programmer's Guide for a fuller description of the new * . ps files. 

The rootmenu is now implemented using the News toolkit instead of Lite. The 
programming interface is different The preferred method of customizing the 
root menu involves modifying files in the SunView rootmenu format and running 
bu i 1 dmenu. See the Xll/NeWS Server Guide for instructions. 



LiteWindow Changes 



In the past, some client programs used get to retrieve the FrameMenu of their 
window in order to change it: 



win /FrameMenu get 



Using get this way is improper, and it was a coincidence of implementation that 
it ever worked at all. In Xii/News, this construct no longer works. Instead, you 
should use send to get the menu: 

/FrameMenu win send 



Note that inxn/NeWS, the frame menu is shared by all instances of LiteWindow. 
If you modify the frame menu in a particular application, all other applications 
ultimately use the modified menu. Thus, instead of modifying the frame menu, 
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Making a Debugging Server 



Chapter 2 — Changes to NdWS 



you should define a ClientMenu for your window. You can include the 
FrameMenu as a submenu of the ClientMenu if you wish. You should define 
the ClientMenu during window initialization: 



/win framebuffer/new DefaultWindow send def 

{ 
/CreateFrameMenu win send 
/ClientMenu [ 

(First Function) { first } 
(Second Function) {second} 
(Frame =>) /FrameMenu win send 

] /new DefaultMenu send def 
} win send 



The procedures 'go!' and 'DebuggingServer?' have been removed. To make 
the server start up an executive session on the terminal from which you start it, 
you should change, within your . user . ps file, the statement 



/DebuggingServer? true def 



to the following: 

. 



/&main /&main load {executive} append cvx def 



This redefines the "main routine" of the server to start an executive session. 



Verbose Loading 



2.5. Changes in NeWS Class 
Implementation 



2.6. Look and Feel 
Changes 



The old * verbose?' flag, which made the server print out the files as it loaded 
them, has been removed from in it . ps. To achieve the same effect, simply 
replace LoadFile in your . startup . ps file so that it provides some feedback 
(note that if you redefine LoadFile in your . user . ps file, the change takes 
place after most files have been loaded.) 

Many new operators and methods are now available for use with classes. These 
operators and methods are described in detail in Chapter 4, Classes, of the AfeWS 
Programmer's Guide. The class system now supports multiple inheritance. See 
the NSVS Programmer's Guide for details. 

Also, there is a new class-based event manager named ClassEventMgr. This is 
simply a class-based use of the existing forkeventmgr- eventmgrinterest pair. 

The default typing style in OPEN LOOK is click-to-type, meaning that you must 
click the left mouse button in a window before it can receive your keystrokes. If 
you are familiar with xhefocus-follows-cursor style, which was previously used 
by News, the new style may take some getting used to. 

It is possible to set the typing style back to focus-follows-cursor by adding the 
following line to your ~ / . Xde fault s file: 



♦ 
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2.7. New and Modified 
NeWS Operators 



New Operators 



You can also use the Properties program on the rootmenu to change back to 
focus-follows-cursor style. 

This section discusses NeWS operators that have been either added or modified 
since News 1.1. See the N<ws Programmer's Guide for information on these 
operators. 

The following operators are new: 



Table 2-1 New Operators 



canvasesunderpath 


getcard32 


putcard32 


canvasesunderpoint 


getcolor 


refcnt 


countfileinputtoken 


getfileinputtoken 


reffinder 


createcolormap 


getprocesses 


setbackcolor 


createcolorsegment 


getprocessgroup 


setbackpixel 


currentbackcolor 


grabcursor 


setcursorlocation 


currentbackpixel 


harden 


setpacking 


currentpacking 


lasteventkeystate 


setpixel 


currentpixel 


lasteventtime 


setplanemask 


currentplanemask 


lasteventx 


setshared 


currentshared 


lasteventy 


soft 


currentstate 


newcursor 


soften 


encodefont 


objectdump 


truetype 


eoextenddamageall 


packedarray 


writeobject 


extenddamageall 


postcrossings 





Renamed Operators 



Polymorphic Operators 



The following operators have been renamed: 
□ X 

This operator is now named shutdownserver. 
a forkunix 

This operator is now named runprogram. 

The following operators now have two possible syntactic forms: 
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createcolorsegment 

encodefont 

expressinterest 

getfileinputtoken 

movecanvas 

newcanvas 

newcursor 

reshapecanvas 

revokeinterest 

setfileinputtoken 



Raster-Op Code not Reset 
After setrasteropcode 



2.8. Improved Support of 
the PostScript 
Language 

Image Operators Implemented 

2.9. New Types 



2.10. Changes to Existing 
Types 



In News 1 . 1, a bug existed whereby certain operations, if performed after the 
raster-op code was set, caused the raster-op code to be reset to another value. In 
Xii/NeWS 1.0, you must explicitly reset the raster-op code. Applications that rely 
on the raster-op code being non-explicitly reset may now paint their canvases 
strangely. 

OpenWindows includes additional support for the PostScript language as 
defined by Adobe Systems in the PostScript Language Reference Manual. 

The settransfer and currenttransfer functions are implemented. 

The following types are new: 

/colormaptype 

/colormapentrytype 

/cursortype 

/environmenttype 

/packedarraytype 

/visualtype 

See the Afews Programmer's Guide for information on these types. 

OpenWindows contains all the types that exist in News 1.1. However, some of 
the types now contain additional keys and have new functionality. The changes 
are listed in the sections below; see the N<ws Programmer's Guide for more 
detailed information. 



2.11. Paths 



The type formerly named shapetype is now named pathtype. 
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2.12. Canvases 



The following keys are new: 

Cursor 

Colormap 

Grabbed 

GrabToken 

Visual 

VisualList 

OverrideRedirect 

BorderWidth 

UserProps 

XID 

SharedFile 

RowBytes 



Change in the Behavior of 
Transparent Canvases 



Overlays 



2.13. Events 



InNeWS 1.1, making a transparent child canvas retained would change its parent 
to be retained; however, the converse, making a transparent retained child non- 
retained had no effect. 

In xn/News, making a transparent child retained or non-retained does not affect 
the transparent canvas or its parent. 

News 1.1 handled only one overlay at a time. If more than one existed, you 
would generally only get correct behavior from the most recently created over- 
lay. xu/News can handle multiple simultaneous active overlays. 

The following keys are new: 

IsPreChild 
Coordinates 



Input Handling Changes 



As part of the merge withxn, there have been a number of changes in News' 
input handling. One major change is that global interests have been replaced 
v/ith pre-child interests. 

Attendant incompatibilities include: 

d If the Canvas field of an interest contains null, the interest is placed on the 
root canvas' pre-child interest list, but the Canvas field remains null. 

a In event delivery, an event with an explicit destination canvas is tested for a 
match against pre-child interests on each of its ancestors (in root-to-leaf 
order) before being tested against the destination canvas. 

d In event delivery, the Canvas field of the delivered event is no longer 
modified to indicate the canvas of the interest that matched the event; that 
information is available from the Interest field of the delivered event, as it 
has always been. 
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Internal Implementation of 
eventmgrinterest and 
forkeventgmr 



Changed Action on Canvas 
Entry/Exit 



eventmgrinterest returns an interest that you pass to forkeventmgr. The inter- 
face to these operators is unchanged from News 1.1 in Xii/News, however, their 
implementation is different. Programs should not assume any particulars about 
the internal format of the interests used by eventmgrinterest/forkeventmgr. 

The value of the Action field in the EnterEvent or ExitEvent (generated when 
the cursor crosses a canvas) is different in XU/NeWS than in NeWS 1.1. 



Change in Focus Event 
Naming 



In NeWS 1.1, when a canvas lost the keyboard focus, a /DeSelect event with 
action /InputFocus was generated. This was ambiguous, however, because 
/DeSelect also signals the loss of ownership of the selection named in the Action 
field, and /InputFocus could be the name of a particular selection. 

So, in XU/NeWS, when a canvas loses the focus, an event named /LoseFocus is 
generated instead of a special kind of /DeSelect. 

Focus events are now generated like Enter and Exit events: thus, ancestors of 
the canvas that has the focus receive events, but with different Action values. 



Time Value Changes 



Time stamps in the Xii/News server have been changed, for convenience in 
merging with XI l. This change affects the value of timestamps in NeWS events 
(the TimeStamp field in the event), and the values returned by the currenttime 
and lasteventtime primitives. In NeWS 1.1, ' 1 .0' in a time value was one minute. 
It now is 2 16 milliseconds, or 65.536 seconds. This means that the NeWS clock in 
XU/NeWS "ticks" about 9% slower than before. To convert the new time values 
to minutes, multiply by 1.092267. One second is now about 0.01526, where it 
used to be 0.016667. 



Shared Interests 



Executable Matches 



Special Events 



Interests can now be shared between canvases. The Canvas field of an event can 
thus contain either a single canvas, or a dictionary or array that contains multiple 
canvases. See the NtWS Programmer' s Guide for information. 

Executable matches are now permitted by executable Canvas, Name, and Action 
dictionary values in interests. These provide a highly efficient way of executing 
code according to the canvas on which an interest has been matched. Using this 
procedure, PostScript language constructs such as case, which are normally 
used to vector a matched event to the correct handler, are made unnecessary. 

News now generates the following special events: 

a /Damaged: Damage events are generated for a canvas whenever it is graphi- 
cally damaged (a definition of damage is provided in the chapter Canvases 
of the NAYS Programmer's Guide). The server will not send another damage 
event until the damage has been cleared by use of the damagepath operator. 
The Action key value for the event is null; the Canvas key value specifies 
the affected canvas. 

a /Obsolete: The server generates obsolescence events to inform clients that 
an object is obsolete and that processes should destroy their references to it 
The Action key of the event is a soft reference to the obsolete object. 
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2.14. Processes 



o /ProcessDied: the server generates a ProcessDied event if a process dies 
(quits) when it is still referenced. The Action key of the event specifies the 
process that died. When a process is dead but is still referenced, its State 
key is set to zombie. 

The following keys are new: 

Serror 

errordict 

Priority 

Stdout 

Stderr 

SendContexts 

SendStack 



Changes to Process Objects 



2.15. Changes in Error 
Handling 



Xii/News adds a new key to process objects, Priority. All processes now have a 
priority that they inherit from their parent Currently this priority is not used to 
order their execution or favor certain lightweight processes (as it is in the UNIX 
kernel). 

However, there is a minimum priority that a process must exceed if it is to run. 
If a process's priority is lower than this system-wide minimum, then it is queued 
until the system- wide priority drops. Currently News processes can set their 
priority but cannot influence the system-wide priority. 

The motivation for this change is to support the various flavors of xn Grab- 
Server requests. During a grab, process and system-wide priorities are adjusted 
so that only important system processes (including the repeat key handler, the 
global input distribution process, and the connection managers) and the xn con- 
nection requesting the grab execute. The change should not affect NeWS pro- 
grammers, and Sun advises against developers using the mechanism for their 
own purposes: it is not a general purpose mechanism and is subject to change. 

This section describes the differences in error handling between NeWS 1.1 and 
Xii/News. Note that error handling has changed since preliminary versions of 
XI 1/NeWS. Error handling is now more compatible with the PostScript Language 
Reference Manual. 

Upon detecting an error, NeWS 1.1 would search for an error handler by looking 
for dictionaries called errordict on the dictionary stack. If it found an errordict 
containing the error name as a key, it would execute the associated value. The 
PostScript Language Reference Manual indicates that errordict is a special dic- 
tionary mat can be found in systemdict. The error behavior described in the 
PostScript Language Reference Manual mentions no such dictionary stack 
search. In Xll/NeWS, each process can have a private errordict. This errordict is 
found in systemdict and as a magic key of processes. (See the description of the 
errordict key in the NSVS Programmer's Guide for a description of how this dic- 
tionary is shared.) In Xll/NeWS, this is the only dictionary that is searched for the 
name of the error, when initialized, it contains an entry for each error that the 
server can generate. 
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2.16. Changes to Magic 
Dictionaries 



2.17. NeWS Fonts 



News l.l would override the action listed in errordict if the error was stacko- 
verflowor execstackoverf low. InXli/NeWS, the listed error handler is 
only overridden if the operand stack has less than 10 slots left before it 
overflows, or if the execution stack has less than 3 slots left before it overflows. 
Since operations such as 2000 array aload can cause operand stack overflows 
while the operand stack is still fairly small, the new behavior is therefore some- 
what less restrictive. 

If no error handler was found in the dictionary search, the News 1 . 1 default error 
action would compose the $error dictionary as mentioned in the PostScript 
Language Reference Manual, and place that dictionary in the userdict. If the 
process had no userdict, no $error dictionary would be generated. The condi- 
tional behavior of the News 1. 1 default error action caused problems in finding 
the $error dictionary after an error. Inxn/News, the $error dictionary, which is 
private to each process, can be found in systemdict and as a magic key of the 
process. (See the description of the $error key in the NSVS Programmer's Guide 
for a description of how this dictionary is shared.) Until a process has an error, 
the value is null; thereafter it is a dictionary containing the information men- 
tioned in the PostScript Language Reference Manual. 

"Magic dictionaries" are used by some of the News types, including canvases, 
events, colors, and processes. These had a fixed set of keys inNeWS 1.1. 
Xii/News allows you to add your own keys beyond the fixed set. The fixed set of 
keys are still there when the object is created and still cannot be removed. 

Note that if you misspell one of the existing keys, you will get no complaint, but 
will have created a new key for that one instance of the object only. In News 1 . 1 
the documentation warned programmers not to put arbitrary keys in magic dic- 
tionaries. However, if you did so, the implementation meant that the key would 
be added to all instances of the dictionary, becoming, in effect, global. For 
example, we found many programs that misspelled /TimeStamp as /Timestamp 
when setting the time in events. Other programs would def some key while the 
uppermost dictionary on the stack was an event. It is possible that your programs 
rely on the News 1.1 behavior in such cases. 

The source format forNeWS fonts has not changed. However, the format of the 
News native bitmaps fonts (in the $OPENWINHOME/lib/f onts directory, 
usually with the extension . f b) has changed in xn/NeWS and is thus incompati- 
ble with the News 1 . 1 format. The new format is used by both NeWS and xn 
code; thus, the two protocols can share the same bitmap fonts. Note that the 
Xii/News bitmap format is different from the xn format used by versions of the 
XI l server released by MIT for Suns. 

The format of the News font family files (in the $OPENWlNHOME/lib/fonts 
directory, usually with the extension . f f ) also changes withxn/News. 

These two changes may not affect you, since the Xii/News server comes with a 
full set of fonts in the new format, but if you have developed your own fonts, you 
must proceed as follows: 
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Adobe Bitmap Font Format 



Scalable Fonts 



2.18. Changes to CPS 



Changed CPS routines 



New CPS routines 



1 . Change directory to your own font directory. 

2. Run convert font to convert your font to the new NeWS format. 

3. Run bldf amily to rebuild the font family files in their new formats. 

The NeWS ASCII bitmap font format generated by convert font (1) was 
changed to be compatible with the very latest (version 2.1) Adobe bitmap font 
format specification. This is also whatxn uses, with a slighdy different interpre- 
tation. NeWS used version 1.4. However, the convert font program under- 
stands the old and new versions of the Adobe bitmap font format, as well as the 
XI l interpretation of version 2.1. The differences among these versions are very 
small, convert font also understands old (NeWS 1.1) format font files. To 
convert a font, run convert font on it. The new and old formats have new 
magic numbers, so there is no chance of NeWS or convertf ont getting con- 
fused. 

For more information on font support inXH/NeWS, see the XU/NeWS Server 
Guide. 

A new font format, OpenFont, is supported. This new format allows a single 
font file to be scaled to any point size and rotated to any angle. The suffix for 
these fonts is . f 3b. Typing Is * . f 3b in the directory 
$OPENWINHOME/ lib/ fonts shows which fonts are in this format. A list of 
these fonts is provided in theXU/NeWS Server Guide. 

If your program includes a header file generated by cps, you no longer need the 
following in your C client source: 

#include psio.h 

It is included for you when cps creates the . h file. 

ps_f lush_PostScript ( ) used to call psio_error ( ) itself and would 
exit ( ) if there was an error. It now does not do this — it is the responsibility 
of the client to check for errors. 

ps_close_PostScript ( ) now closes PostScriptlnput as well as 
PostScript. 

There are many new functions for examining the tokens in the client-side input 
queue. 

ps_check_PostScript_event ( ) 
ps_query_PostScript_event (tag) 
ps_read_PostScript_event (ptag) 
ps_peek_PostScript_event (ptag) 
ps_skip_PostScript_event () 

The above routines are supported by new psio routines: 
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ps_checkfor(PostScriptInput,PSIO_CHECK_INPUT,0) 
ps_checkf or (PostScript Input, PSIO_FIND_TAG, tag) 
ps_currenttag (Post Script Input, PSIO_GET_TAG,ptag) 
ps_currenttag (Post Script Input, PSIO_PEEK_TAG,ptag) 
ps_skip (PostScript Input) 

The internal routine next_user_token was changed to 
ps_next_user_token ( ) to avoid name clashes. 

2.19. Memory News provides a facility of reference counting that allows objects to survive as 

Management long as references to them exist; references are created by the system whenever 

one object becomes associated with another. 

In News 1 . 1 there was one kind of reference to an object. There are now two 
kinds of reference: one controls how long an object is in use, and the other is 
used to track an object in the system. When all of the first kind of reference is 
destroyed, the object is said to be obsolete. Processes with references to obsolete 
objects should destroy those references to allow garbage collection to occur. 



When no references of any kind exist to an object, its storage is automatically 
reclaimed. See the News Programmer's Guide for details. 
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Changes to XI 1 



The xn/News server is a different piece of software from the MIT xn distribu- 
tion. No changes have been made to the xn protocol. xn/News is compatible 
with XI l Revision 3. However, there are some differences between Xii/NeWS and 
xi l Revision 3 that should be noted: 

a xi 1/NeWS typically supports multiple color visuals and chooses to make a 
static color visual the default. This promotes sharing of limited color slots. 
This is different from MIT's xn. 

□ Color applications should not assume that the default visual is dynamic (like 
the MIT distribution). They need to look at the visuals returned from the 
xn/News server and locate the dynamic one. Better still, they should use the 
static one so that colors are shared. 

a The Xi l -related files in the distribution are limited to the server, Xlib, some 
demos, and some utilities. The XII Revision 3 version of xterm is provided 
in $OPENWINHOME/demo: it retains the status of pass through or demo 
software. Other libraries and applications should be gleaned from the MIT 
XI l distribution tape. 

a The retained values of closedown mode are unimplemented. 

n Although the XI 1/NeWS font utilities accept the same font source format as is 
found on the MIT distribution, the binary format is incompatible. The 
xn/News server supplies the same fonts as MIT, plus many more. If you 
have your own fonts, you must run convert font and bldf amily on 
them. See the Xll/News Server Guide for information on fonts and font nam- 
ing conventions. 

a The default window manager pswm is ICCCM compliant, as all release 4 
window managers will be. The ICCCM specifies the split between applica- 
tions and the window manager. See the Xll/NeWS Server Guide for a discus- 
sion of the window manager. See the manual page for xnews in the 
XI 1 /News Server Guide for a description of how to use the environment vari- 
able XI 10NLY to prevent the window manager from starting. 
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